home *** CD-ROM | disk | FTP | other *** search
/ PC Media 2 / PC MEDIA CD02.iso / share / os2 / newdesk / desktop.doc next >
Encoding:
Text File  |  1989-11-07  |  11.5 KB  |  286 lines
  1.  
  2.                                PM Desktop 1.2
  3.                                      by
  4.                                Darrin Massena
  5.                                  17-Sep-89
  6.  
  7.  
  8. * ABOUT PM DESKTOP
  9.  
  10. PM Desktop is a simple application designed to enhance the OS/2 Presentation 
  11. Manager environment.  PM Desktop is currently most useful for putting fancy 
  12. images on the desktop background and to generally impress and amaze your 
  13. friends with how cool OS/2 PM is.  In the future, PM Desktop will provide 
  14. many more useful (and not so useful) enhancements to the PM environment.  
  15.  
  16. I wrote PM Desktop in my spare late-night hours and weekends and it is not a 
  17. Microsoft sponsored or supported program.  I hope this help file answers all 
  18. your questions about PM Desktop since I don't have much spare time to 
  19. support it myself.  
  20.  
  21. The three Desktop files (DESKTOP.DLL, DESKTOP.EXE, DESKTOP.DOC) should all 
  22. be distributed together since only two of them, without the other, could be 
  23. worse than useless.  
  24.  
  25.  
  26.  
  27. * INSTALLING PM DESKTOP
  28.  
  29. Installing PM Desktop is a simple 5 step process:
  30.  
  31. 1. Get OS/2 1.2 with PM up and running.
  32. 2. Put the DESKTOP.DLL somewhere on your LIBPATH, i.e. \os2\dll.
  33. 3. Execute the PM Desktop command program with the install option flag,
  34.    "desktop -i".
  35. 4. Reboot OS/2 and PM.
  36. 5. Pat yourself on the back, you're all finished.
  37.  
  38.  
  39.  
  40. * USING PM DESKTOP
  41.  
  42. Using PM Desktop is easy- just click somewhere on the desktop surface, some- 
  43. where where the screen background isn't covered by a window, and up pops the 
  44. Desktop Menu.  You'll notice many disabled menu items; PM Desktop doesn't 
  45. get as much development attention as it deserves and many features are 
  46. currently disabled because they're either buggy or just unimplemented.  
  47. These features and more will be enabled in future versions of PM Desktop.  
  48.  
  49. These are the currently implemented features as shown on the Desktop Menu.  
  50. '+' denotes a submenu title and '-' an individual submenu item.  
  51.  
  52.  
  53. Background...
  54.  
  55. Selecting 'Background...' allows you to select a new background picture for 
  56. your desktop.  Use the file dialog to find the background picture you want 
  57. and double-click on it, or press the 'Open' button to load and display the 
  58. new picture.  If the file you select is not a valid PM bitmap, then the 
  59. current picture will be thrown away and no new picture will be displayed.  
  60.  
  61.  
  62. + Settings
  63.  
  64. The 'Settings' submenu allows you to control various Desktop parameters via 
  65. several configuration dialogs.  Most settings are written out to OS2.INI and 
  66. become permanent -- even across machine reboots -- until you next change 
  67. them.  
  68.  
  69. - PM Desktop...
  70.  
  71. The 'PM Desktop...' settings dialog can be used to configure the general 
  72. behavior of PM Desktop.  It provides control over how the Desktop Menu is 
  73. invoked, how the background picture should be displayed, and whether or not 
  74. PM Desktop adds the Desktop Menu to all windows that have a System Menu on 
  75. them.  
  76.  
  77. If 'Enable '/' Menu' is not selected (default), PM Desktop leaves your 
  78. window's System Menus alone.  If the '/' menu enabled, PM Desktop adds the 
  79. Desktop Menu into the System Menu of all windows created from then on.  This 
  80. allows you to get to PM Desktop's functions even when the desktop is 
  81. completely obscured, say by a maximized application.
  82.  
  83. 'Enable VIO Pasting' enables a new command on the system menu of VIO 
  84. applications running in a window, like CMD.EXE.  The new command 'Paste' 
  85. allows the contents of the clipboard to be pasted into the window.  When 
  86. combined with the VIO 'Mark' and 'Copy' commands, this very handy feature 
  87. provides complete cut/paste ability to people who use VIO editors and other 
  88. OS/2 character mode applications.  Thanks to Mark Taylor for this feature.
  89.  
  90. The 'Debug' checkbox is for people who are running 'debug' versions of OS/2.  
  91. It changes the way PM Desktop repaints the background such that the debug 
  92. version string appears at the bottom of the screen.  This has the nasty side 
  93. effect of causing the background to be repainted incorrectly under certain 
  94. rare timing situations.  If you use a retail version of PMWIN or you aren't 
  95. interested in seeing the version string, leave this option in its default 
  96. state (disabled).  
  97.  
  98. The group of 'Desktop Menu Activation' radio buttons specifies how you 
  99. invoke the Desktop Menu.  You can choose double-clicking, single-clicking 
  100. (default), or disable the Desktop Menu altogether.  Be careful when 
  101. disabling the Desktop Menu.  If you don't have the '/' menu enabled, you 
  102. won't be able to get at PM Desktop's functions any more.  If this happens by 
  103. accident, you can recover by deinstalling PM Desktop and reinstalling it 
  104. again.  To do this, simply type "desktop -d" (to deinstall) and then 
  105. "desktop -i" (to reinstall).  You must reboot for reinstallation to take 
  106. effect.  
  107.  
  108. The 'Background Type' group allows background pictures to be displayed in 
  109. several different ways.
  110.  
  111.    'No Background'
  112.    
  113.    Since a full-screen color VGA background picture takes away 153K of your 
  114.    memory or a full-screen 8514A picture takes 786K, you might want to 
  115.    choose the 'No Background' style when memory gets tight.  
  116.  
  117.    'Image'
  118.    
  119.    This is the default and causes the specified picture to be centered on 
  120.    the screen.  If the image is too big to fit, it is clipped to the size 
  121.    of the screen.  
  122.  
  123.    'Tiled Image'
  124.    
  125.    Smaller pictures can be 'wallpapered' across the desktop with this 
  126.    option.  The picture is replicated horizontally and vertically to 
  127.    completely cover the background.  Note: for performance reasons, this 
  128.    takes as much memory as non-tiled full-screen picture.  Very small 
  129.    pictures should be tiled using the memory saving 'Pattern' option.  
  130.  
  131.    'Scaled Image'
  132.    
  133.    When displaying a picture that was created for another display device, 
  134.    use this option to scale (stretch/shrink) the picture to cover the 
  135.    background.  Note: there is a known OS/2 bug that will cause an error to 
  136.    occur when scaling very small bitmaps into large bitmaps.  If you select 
  137.    'Scaled Image' and the resultant background looks like garbage, try 
  138.    another display option or a new larger picture.  
  139.    
  140.    'Pattern'
  141.    
  142.    If you like a simple repetative background images, 'Pattern' is the 
  143.    display option for you.  'Pattern' takes the first 8x8 area of the 
  144.    background picture and tiles it over the whole screen.  'Pattern' has an 
  145.    advantage over 'Tiled Image' because it uses far less memory.  A typical 
  146.    8x8 pattern only requires 128 bytes of memory, compared with the 
  147.    153,000+ bytes required by a tiled or full-screen picture.  
  148.  
  149.  
  150. + Arrange
  151.  
  152.     Minimize - Minimize ALL applications.
  153.     Restore  - Restore ALL applications.  This isn't too useful if you have
  154.                one or more full-screen sessions running.
  155.  
  156. + Switch     - Switch directly to any other application, without going through
  157.                the Task Manager.
  158.  
  159. + Toys
  160.     Stupid   - This dances a few lines around the screen.  Mildly entertaining
  161.                but it has a few painting problems and can leave harmless trash
  162.                on the screen.
  163.     Lively
  164.     Puzzle
  165.     Doodle
  166.     Stars
  167.  
  168. + Snapshot
  169.  
  170. The two different 'Snapshot' menuitems allow you to take a 'snapshot' of a 
  171. window or the screen and place it on the clipboard as a bitmap image.  Once 
  172. a snapshot is taken it can be pasted into any application that can paste 
  173. images from the clipboard.  This can be used to include window and screen 
  174. shots in mock-ups, demonstrations, and documentation.  
  175.  
  176. - Window
  177.  
  178. This snapshots the currently active frame window's image to the clipboard.  
  179. The keyboard equivelent to this menu item is 'Shift+PrintScreen', but will 
  180. not work if the active window is a 'VIO' window.  
  181.  
  182. - Screen
  183.  
  184. This snapshots the entire screen image to the clipboard.  The keyboard 
  185. equivelent to this menu item is 'Ctrl+PrintScreen', but will not work if the 
  186. active window is a 'VIO' window.  
  187.  
  188.  
  189. About...
  190.  
  191. 'About...' tells you a bit about the great guys behind PM Desktop as well as
  192. the current version number.  This document was written for version '1.2' of
  193. PM Desktop.
  194.  
  195.  
  196.  
  197. * USING THE DESKTOP COMMAND PROGRAM (DESKTOP.EXE)
  198.  
  199. This program is provided to support changing the desktop background from 
  200. the CMD.EXE command line or from batch files.  Now, all you people without
  201. mice can still have beautiful desktop backgrounds.  A typical example of
  202. using DESKTOP.EXE would be to load a picture from a network server at boot
  203. time.  Adding something like this to your STARTUP.CMD would do the trick:
  204.  
  205.    ...
  206.    net logon myname /y
  207.    net use o: \\os2stuff\pmdemos
  208.    desktop -s o:\bitmaps\nifty.bmp
  209.    ...
  210.  
  211. Other possibilities include launching a command file a periodic intervals
  212. to change your background picture.  Even simple slide shows are possible.
  213. DESKTOP.EXE supports almost all the options that are accessible from the 
  214. Desktop Menu.  Here's the syntax for the DESKTOP.EXE's parameters.
  215.  
  216. Usage: desktop [-cdinprst?] [-x #] [-y #] [picname]
  217.  
  218. Options:
  219.   -c : Centers the picture on the screen.
  220.   -d : Deinstalls PM Desktop completely (upon reboot).
  221.   -i : Installs PM Desktop in OS2.INI, resets Desktop Options.
  222.   -n : Removes the background picture (frees picture memory).
  223.   -p : Uses the picture as an 8x8 pattern (takes less memory than tiling).
  224.   -r : Retain the picture name in OS2.INI for next boot.
  225.   -s : Scales the picture to fill the screen.
  226.   -t : Tiles the picture, filling the screen.
  227.   -? : Print this help message.
  228. -x # : Places the picture at the specified x coordinate.
  229. -y # : Places the picture at the specified y coordinate.
  230.  
  231. Some options (-dir) have no effect until the system is rebooted.
  232.  
  233.  
  234.  
  235. * WHERE TO FIND SOME PICTURES
  236.  
  237. On \\hagar\scratch \c-stankr\pics there is a text file called 'registry'.  
  238. This file contains a listing of servers that have PM .BMP format pictures 
  239. which can be used as PM Desktop backgrounds.  If you have pictures of your 
  240. own that you'd like to share just add your server\share to the registry
  241. document.
  242.  
  243.  
  244.  
  245. * USING THE DESKTOP API
  246.  
  247. The PM Desktop DLL provides application interfaces for querying the PM 
  248. Desktop state, setting the desktop background, and loading PM .BMP format 
  249. bitmap files.  Documentation on these Desktop APIs is in the DESKTOP.H 
  250. file.  DESKTOP.H and DESKTOP.LIB along with the source for DESKTOP.EXE can 
  251. be found on \\toys\desktop.
  252.  
  253.  
  254.  
  255. * BUGS? FEATURES?
  256.  
  257. If, by chance, you find any bugs in PM Desktop, send mail to me (darrinm)
  258. describing how to reproduce the problem and I'll fix it.  If you have any
  259. ideas for neat new features that would be appropriate for PM Desktop, send
  260. 'em to me and I'll see what I can fit in.
  261.  
  262.  
  263.  
  264. * CHANGES AND ENHANCEMENTS
  265.  
  266. Ver 1.2, 17-Sep-89
  267.  
  268. Works under OS/2 1.2.
  269. Replaced DESKINST.EXE with the new PM Desktop command program, DESKTOP.EXE.
  270. Added new background settings TILE, SCALE and PATTERN.
  271. Added VIO Paste enabling capability.
  272. Rearranged menus a bit, removed some dead wood.
  273. The Stupid toy is now colorful.
  274. Misc optimizations, DESKTOP.DLL is now ~500 bytes smaller.
  275. Removed 'Arrange tile, cascade' because of changes to the Desktop Manager.
  276. Fixed misc rude bugs.
  277.  
  278. Ver 1.21, 29-Sep-89
  279.  
  280. Added support for BITMAPARRAYs.  Now you can create desktop background 
  281. images and patterns with the Icon Editor.
  282. Now automatically switches to 'Image' display mode if you load a desktop
  283. background while none is currently being displayed.
  284. Added a work-around for the initial desktop painting bug in PMWIN.
  285.  
  286.